home *** CD-ROM | disk | FTP | other *** search
/ Aminet 34 / Aminet 34 (2000)(Schatztruhe)[!][Dec 1999].iso / Aminet / dev / asm / SineWriter.readme < prev   
Encoding:
Text File  |  1999-11-06  |  2.6 KB  |  73 lines
  1. Short:    Generate fixed point sine/cosine/hybrid lookup tables
  2. Author:   Duane McDonnell <tachyon@tolstoi.saccii.net.au>
  3. Uploader: Duane McDonnell <tachyon@tolstoi.saccii.net.au>
  4. Type:     dev/asm
  5.  
  6. INTRODUCTION
  7.  
  8. Generate sine, cosine and sine/cosine hybrid LUTs for use in game/demo
  9. code (particularly 3D programming). This might be useful for coders who
  10. use fixed point math for calculations rather than FPU instructions.
  11.  
  12.  
  13. USAGE
  14.  
  15. Here's a quick run-down of the main options:
  16.  
  17. Table types:
  18.  
  19. Sine        Generates sine tables from 0..360 deg (0..2pi rad)
  20.  
  21. Cosine        Generates cosine tables from 0..360 deg (0..2pi rad)
  22.  
  23. Hybrid        Generates a sine table followed by a cosine table to save
  24.         memory. Since sine and cosine are 90 deg (pi/2 rad) out
  25.         of phase you don't need two full-size tables.
  26.  
  27. Table data size:        Byte, Word, Longword.
  28.  
  29. Amplitude scaling factor:    The factor to scale the amplitude by (eg:
  30.                 for <2.14> fixed point format, 1.0 equals
  31.                 16384, so 16384 is the scaling factor).
  32.  
  33. Table resolution:        The number of entries to calculate in a
  34.                 full 360 degree wave. Usually you'd make
  35.                 this a power of two to simplify angular
  36.                 range clipping. Eg: 1024 means there are
  37.                 1024 entries in a 360 degree wave so the
  38.                 "resolution" is 360/1024. Because of the
  39.                 symmetry requirement this value must be
  40.                 divisible by 4.
  41.  
  42. Save table data as:        Source (68k assembly), Binary.
  43.                 
  44. The generated tables are 90 deg (pi/2 rad) symmetrical and are
  45. calculated using a Taylor series polynomial sufficiently accurate
  46. for the data size selected. No external math libraries are required.
  47.  
  48. Numerical input can be in decimal or hexadecimal format. Precede hex
  49. values with a dollar "$" sign.
  50.  
  51. Pressing RETURN alone at any prompt will return you to the main menu.
  52.  
  53.  
  54. FINAL WORDS
  55.  
  56. This is a support tool I wrote years ago during the good ol' days
  57. of the demo scene ('92 or '93 I think). I came across this while
  58. rummaging around my hard drive. I'm releasing this in case there are
  59. demo coders who don't have decent table generation code of their own.
  60. Note that I cannot support this program as I don't have the time or
  61. interest but I'll be happy to answer any questions. Excuse the crappy
  62. shell-GUI, it does the job though :-)
  63.  
  64.  
  65. ============================= Archive contents =============================
  66.  
  67. Original  Packed Ratio    Date     Time    Name
  68. -------- ------- ----- --------- --------  -------------
  69.     6140    3390 44.7% 25-Sep-99 00:09:38 +SineWriter
  70.     2222    1183 46.7% 25-Sep-99 00:16:12 +SineWriter.readme
  71. -------- ------- ----- --------- --------
  72.     8362    4573 45.3% 17-Sep-99 21:32:44   2 files
  73.